class CRPESectionOptions

This class contains specifications for formatting selected report sections. This information is used by the methods CRPEJob::GetSectionFormat, and CRPEJob::SetSectionFormat.

Data Members

m_visible

Specifies whether or not the selected section is to be visible. Use TRUE to keep the section visible, FALSE to hide the section.

m_newPageBefore

Specifies whether or not the Crystal Report Engine is to insert a page break before the section is printed. Use TRUE to insert a page break, FALSE to leave it without a page break.

m_newPageAfter

Specifies whether or not the Crystal Report Engine is to insert a page break after the section is printed. Use TRUE to insert a page break, FALSE to leave it without a page break.

m_keepTogether

Specifies whether or not the Crystal Report Engine is to keep all lines of the section together, either on the current page (if there is room), or on the next page. Pass TRUE to keep the lines together, FALSE to allow the Crystal Report Engine to split section data from one page to the next if necessary.

m_suppressBlank
Lines

Specifies whether or not the Crystal Report Engine is to eliminate lines from your report that are blank due to fields being suppressed (zeroes, duplicates, and hidden fields). TRUE eliminates blank lines. FALSE retains them.

m_resetPageNAfter

Specifies whether or not the Crystal Report Engine is to reset the page number to one (1) for the following page, after it prints a group total. Use TRUE to reset the page number, FALSE to keep standard numbering.

m_printAtBottom
OfPage

Specifies whether or not the Crystal Report Engine is to cause each group summary value to print only at the bottom of a page. Use TRUE to print summaries at the bottom of the page, FALSE to print summaries immediately after the group.

Constructor CRPESectionOptions::CRPESectionOptions
Constructor Syntax
CRPESectionOptions (visible BOOLEAN : FALSE, newPageBefore BOOLEAN : 
FALSE, newPageAfter BOOLEAN : FALSE, keepTogether BOOLEAN : FALSE, 
suppressBlankLines BOOLEAN : FALSE, resetPageNAfter BOOLEAN : FALSE, 
printAtBottomOfPage BOOLEAN : FALSE)
Constructor Parameters

visible

Specifies whether or not the selected section is to be visible. Use TRUE to keep the section visible, FALSE to hide the section. Assigns this value to the CRPESectionOptions::m_visible member.

newPageBefore

Specifies whether or not the Crystal Report Engine is to insert a page break before the section is printed. Use TRUE to insert a page break, FALSE to leave it without a page break. Assigns this value to the CRPESectionOptions::m_newPageBefore member.

newPageAfter

Specifies whether or not the Crystal Report Engine is to insert a page break after the section is printed. Use TRUE to insert a page break, FALSE to leave it without a page break. Assigns this value to the CRPESectionOptions::m_newPageAfter member.

keepTogether

Specifies whether or not the Crystal Report Engine is to keep all lines of the section together, either on the current page (if there is room), or on the next page. Pass TRUE to keep the lines together, FALSE to allow the Crystal Report Engine to split section data from one page to the next if necessary. Assigns this value to the CRPESectionOptions::m_keepTogether member.

suppressBlank
Lines

Specifies whether or not the Crystal Report Engine is to eliminate lines from your report that are blank due to fields being suppressed (zeroes, duplicates, and hidden fields). TRUE eliminates blank lines. FALSE retains them. Assigns this value to the CRPESectionOptions::m_suppressBlankLines member.

resetPageNAfter

Specifies whether or not the Crystal Report Engine is to reset the page number to one (1) for the following page, after it prints a group total. Use TRUE to reset the page number, FALSE to keep standard numbering. Assigns this value to the CRPESectionOptions::m_resetPageNAfter member.

printAtBottom
OfPage

Specifies whether or not the Crystal Report Engine is to cause each group summary value to print only at the bottom of a page. Use TRUE to print summaries at the bottom of the page, FALSE to print summaries immediately after the group. Assigns this value to the CRPESectionOptions::m_printAtBottomOfPage member.

Remarks
Related Report Engine Calls

PESectionOptions



Seagate Software IMG Holdings, Inc.
http://www.seagatesoftware.com
Support services:
http://support.seagatesoftware.com